home *** CD-ROM | disk | FTP | other *** search
/ Mac Magazin/MacEasy 32 / Mac Magazin and MacEasy Magazine CD - Issue 32.iso / Grafik & Text / OzTeX3.0 / Help-files / Changes to OzTeX 2.1 < prev    next >
Text File  |  1997-02-26  |  22KB  |  454 lines
  1. Changes to OzTeX 2.1
  2. ====================
  3.  
  4. OzTeX 3.0 is a major new release with many important changes.  Please read
  5. the following information carefully.  There are a number of sections:
  6.  
  7.   OzTeX and dvips
  8.   The Tools menu
  9.   Previewing
  10.   Printing
  11.   Configuration files
  12.   Virtual fonts
  13.   Miscellaneous
  14.   OzMF
  15.   OzMP
  16.  
  17. OzTeX and dvips
  18. ---------------
  19.  
  20. • OzTeX's built-in DVI-to-PostScript translator has been replaced by dvips.
  21.   The merger of OzTeX and dvips has a number of significant advantages:
  22.  
  23.   The OzDVIPS application is no longer necessary.  No separate Default file
  24.   means that the search paths for PK/TFM/VF/EPSF files will always match.
  25.   (dvips now uses input_folders rather than figure_folders to search for
  26.   \special files.  The header_folders parameter is also not needed because
  27.   dvips now uses ps_folders to locate .pro/.enc files and downloaded fonts.)
  28.  
  29.   The total memory for OzTeX-with-dvips is a lot less than OzTeX + OzDVIPS.
  30.   
  31.   dvips has become the de facto standard for DVI-to-PS drivers.
  32.   It is free, well-supported and widely available for all platforms.
  33.   DVI files are more portable if they use dvips-specific \specials.
  34.   Also, the LaTeX packages support dvips better than any other driver.
  35.  
  36.   dvips output conforms to Adobe's document structuring conventions; this
  37.   is required by PS-reading tools like PSbook and PSnup (now in OzTeX).
  38.  
  39.   dvips has better support for graphics (eg. color/rotation).  It also has
  40.   a much better scheme for modifying PostScript fonts in various ways
  41.   (eg. reencoding/slanting/condensing).
  42.  
  43.   Instead of supporting two DVI-to-PS drivers, I can spend more time on
  44.   other ways to improve OzTeX!
  45.  
  46. • The new version of dvips included in OzTeX 3.0 has some handy features:
  47.  
  48.   Partial downloading of Type 1 PostScript fonts.  This option is disabled
  49.   by default; use -j to turn it on.  I've modified dvips so that Mac
  50.   PostScript fonts (LWFN files) are also partially downloaded.
  51.  
  52.   Support for HyperTeX \specials.  Use -z to enable the generation of
  53.   "HyperPostScript" that can be run through Adobe Distiller to produce a
  54.   PDF file with hypertext links.  For more information, see the article by
  55.   Mark Doyle in TUGboat vol.16 no.2, or visit http://xxx.lanl.gov/hypertex/.
  56.  
  57.   Downloading of PostScript fonts used (but not included) in EPSF files.
  58.   Such fonts will only be downloaded if they appear in the psfonts.map file
  59.   along with a "<" entry specifying the pfa/pfb/LWFN file to be downloaded.
  60.   See the bottom of :DVIPS:Inputs:psfonts.map for some examples.
  61.  
  62. • I've extended dvips to handle all the OzTeX-specific \special commands for
  63.   including PICT/PNTG/EPSF files.  I've also added support for the old method
  64.   of including raw PostScript files followed by arbitrary PostScript code,
  65.   although this is not something I would recommend doing (EPSF files are
  66.   much safer).  Because of conflicts with dvips-specific \special commands,
  67.   there are some rare situations where inclusion of a raw PostScript file
  68.   will no longer work.  In such cases you will need to add the new "rawps"
  69.   keyword; eg. \special{rawps=foo.ps ...}.
  70.  
  71. • The low-level PostScript printing dialog has changed slightly:
  72.  
  73.   Two new radio buttons allow the PostScript code generated by dvips to be
  74.   sent directly to the printer or to a file.
  75.  
  76.   A new pop-up menu makes it easier to add extra dvips options.  Selecting an
  77.   option from the menu will automatically append it to the current options.
  78.   If an option requires a parameter then OzTeX selects the parameter template
  79.   so you can simply type in the desired number, string, or whatever.
  80.  
  81.   The edit boxes for page copies and DVI magnification have been removed.
  82.   You will need to enter appropriate dvips options; eg. -c2 or -x1200.
  83.  
  84. • I've also extended dvips so that its output will work with the standard
  85.   print drivers (when "Use Standard PostScript" is ticked).  The print dialog
  86.   has a new pop-up menu for adding extra dvips options.  The items in this
  87.   menu are slightly different to those in the low-level dialog because some
  88.   options either cannot be used or don't make sense when merging dvips output
  89.   with the PostScript code generated by Apple's standard print drivers.
  90.  
  91.   NOTE: Due to incompatibility problems, the pop-up menu is not available
  92.   in the print dialog for LaserWriter 8.4.x or later.
  93.  
  94. • Various *.tex/sty files have been moved from :DVIPS:Docs: into a new DVIPS
  95.   subfolder in TeX-inputs.  One of these files is a new version of epsf.tex
  96.   (the old version has been removed from :TeX-inputs:Plain:).
  97.  
  98. • The rotation examples in TeX-docs (rotate.tex, rotate.ps and table.tex)
  99.   have been deleted.  LaTeX users should use the rotation commands in the
  100.   graphics/x package; Plain TeX users should see :DVIPS:Docs:rotsample.tex.
  101.  
  102. The Tools menu
  103. --------------
  104.  
  105. • OzTeX has a new Tools menu.  DVIDVI and DVIcopy (formerly "Fix VFs in DVI")
  106.   have been moved from the TeX menu to the Tools menu.  This menu also contains
  107.   the latest versions of Angus Duggan's utilities for manipulating PostScript
  108.   files.  New items in the Help menu describe PSbook, PSnup, etc.
  109.  
  110. • The Tools menu also contains DVIPS.  This is provided so you can always
  111.   create a .ps file even if the currently chosen printer is non-PostScript.
  112.   When dvips is called from Print DVI in the File menu then the default
  113.   destination is the printer.  If called from DVIPS in the Tools menu then
  114.   the default destination is a .ps file.
  115.   
  116.   NOTE: If you option-click on the Save button then OzTeX will skip the
  117.   save-file dialog and create foo.ps in the same folder as foo.dvi.
  118.  
  119. • DVIDVI and the PS tools look for a file called "<tool> examples" in the
  120.   help_folder and, if found, display it before the "Options" prompt.
  121.   Feel free to remove/rename/edit the supplied files.
  122.  
  123. • DVIDVI and the PS tools can be asked to create an output file with the
  124.   same name as the input file (OzTeX temporarily renames the input file).
  125.   They will also repeat the "Options" prompt if an error is detected in the
  126.   given options, so no need to select the input and output files again.
  127.  
  128. • The File menu has a new "Send foo.ps" item.  The file name shown is the
  129.   most recent output file created by dvips or the PS tools.
  130.  
  131. • If the Option key is held down while selecting an item in the Tools menu
  132.   then OzTeX will skip the open-file dialog and use the current DVI/PS file.
  133.  
  134. Previewing
  135. ----------
  136.  
  137. • Major changes have been made to the way OzTeX processes a DVI page.
  138.   In previous versions, OzTeX would first collect all the \specials, rules
  139.   and characters used on a page in separate lists.  These lists would then be
  140.   used to display/print all the \specials first, then all the rules, then all
  141.   the characters (font by font).  Thus the original ordering of the various
  142.   page elements was lost.
  143.  
  144.   While quite efficient, OzTeX's approach was at odds with the standard
  145.   method used by virtually all other DVI translators (especially dvips).
  146.   In particular, it meant that OzTeX could not support macro packages that
  147.   used one \special command to change some state (like the current color)
  148.   and another \special to restore the state.  These sort of \specials are
  149.   an important way of extending TeX's limited graphic capabilities, so OzTeX
  150.   now processes all \specials, rules and characters in the same order as
  151.   their occurrence in the DVI page.
  152.  
  153.   NOTE: Most people won't notice any difference as a result of this change.
  154.   However, if you relied on the fact that OzTeX printed all the \specials on
  155.   a page first (eg. to overlay text on a grey background) then you might
  156.   have to change the location of some \special commands.
  157.  
  158. • The previewer now supports the HyperTeX \special commands.
  159.   These \specials let you jump to another place in a document by simply
  160.   clicking on a link, such as a reference to a section number.
  161.  
  162.   The hyperref package (now supplied in the :TeX-inputs:HyperRef: folder)
  163.   makes it very easy for LaTeX users to add HyperTeX links to their documents.
  164.   Just add \usepackage{hyperref} before \begin{document}, delete any .aux and
  165.   .toc files (to avoid a hyperref bug), then run LaTeX a couple of times.
  166.  
  167.   To see how HyperTeX links work, have a look at ozuser.dvi and hyper.dvi in
  168.   the LaTeX-docs folder.  All links are underlined and, on a color monitor,
  169.   are colored green.  If the mouse moves over a link then the cursor changes
  170.   to a pointing finger.  Clicking on a link will take you to the target.
  171.  
  172.   There are two new items in the View menu: Back Link and Forward Link.
  173.   Their keyboard short cuts are "[" and "]" respectively.  These items make
  174.   it easy to move to previously visited links; they work just like the
  175.   Back/Forward buttons in a Web browser.
  176.  
  177.   NOTE: At the moment, OzTeX only supports internal links (links to targets
  178.   within the same DVI file).  Eventually I hope to support links to other DVI
  179.   files on the current computer, or anywhere on the Internet.
  180.  
  181. • The previewer now supports the color \special commands used by dvips and
  182.   generated by LaTeX's color package.  The new hyper.tex file in LaTeX-docs
  183.   shows how the color package can be used.  For more details, see the new
  184.   section on color in the User Guide.
  185.  
  186.   NOTE: The color \specials are not yet supported for QuickDraw printers;
  187.   that will have to wait until I buy a color printer.
  188.  
  189. • A few changes have been made to the keyboard short cuts recognized by OzTeX
  190.   while previewing a DVI file.  Here is a complete list of all short cuts:
  191.  
  192.   - Type "o" to bypass the view dialog and open the most recently viewed page.
  193.   - Type "w" to close the view window.
  194.   - Type "i" to see page info.
  195.   - Type "b" to move to the bottom of the previous page.
  196.   - Type "n" to move to the top of the next page.
  197.   - Type "g" to go to a given page and restore the default view.
  198.   - Type "<num>g" to go to DVI page <num> (eg. "12g" will go to DVI page 12).
  199.   - Type "<num>t" to go to TeX page <num> (eg. "13t" will go to TeX page 13).
  200.   - Type "[" to go back one HyperTeX link.
  201.   - Type "]" to go forward one HyperTeX link.
  202.   - Type "f" to change the scale to full view.
  203.   - Type "a" to change the scale to actual size.
  204.   - Type "d" to toggle the dither option (System 7 or later is required).
  205.   - Type "h" (or Home) to go to the first page and restore the default view.
  206.   - Type "e" (or End) to go to the last page and restore the default view.
  207.   - Hit the space bar (or Page Down) to scroll forwards.
  208.   - Hit the Delete key (or Page Up) to scroll backwards.
  209.   - Hit the arrow keys to scroll just like clicking in the scroll bar arrows.
  210.   - Hit the Return key to toggle between the view window and OzTeX window.
  211.  
  212.   NOTES:
  213.  
  214.   "-1g" will go to the last page, "-2g" to the 2nd last page, etc.
  215.   "99g" will also go to the last page if there are fewer than 99 pages.
  216.   "99t" will only go to TeX page 99 if it exists; if not, OzTeX beeps and
  217.   the page selection dialog appears.
  218.  
  219.   OzTeX now supports the Home, End, Page Up and Page Down keys available on
  220.   extended keyboards.  These keys are also supported in the OzTeX window.
  221.  
  222.   The old "f" and "l" short cuts for first and last page have been changed
  223.   to "h" (for home) and "e" (for end).  They also restore the default view.
  224.   The main reason for this change is to allow "f" to be a short cut for
  225.   Full View.  All the command-key items in the View menu now have matching
  226.   short cuts.
  227.  
  228. • The roles of a simple click and an Option-Command-click have been reversed.
  229.   A simple click now magnifies the area under the cursor.  This area can now
  230.   be moved around while holding down the mouse button; if the mouse moves
  231.   outside the viewing area then scrolling will occur.  These new features
  232.   are so convenient that I decided most people would prefer access to them
  233.   using a simple click rather than the Option-Command-click contortion.
  234.  
  235.   An Option-Command-click will now zoom in by doubling the scale factor,
  236.   or if the mouse button is held down and dragged then OzTeX will zoom into
  237.   the selected rectangle.
  238.  
  239.   NOTE 1. If you prefer the old clicking methods then open OzTeX Prefs in
  240.   ResEdit and change STR 214 to "T".  (Then restart OzTeX.)
  241.  
  242.   NOTE 2. The dimensions of the magnified rectangle can be changed by opening
  243.   OzTeX Prefs in ResEdit and altering the numbers in STR 240 and 241.
  244.   If you want the magnified area to fill the view window then set both numbers
  245.   to huge values (eg. 8000).  Setting either number to a value less than 5
  246.   will prevent any magnification.
  247.  
  248.   NOTE 3. The left edge of the standard view window has been moved in 1 pixel
  249.   so that scrolling can occur if the cursor moves outside the left edge while
  250.   dragging the magnified rectangle.
  251.  
  252. • The View DVI dialog has a new "Dither bitmaps" option which tells OzTeX
  253.   whether or not to dither the bitmaps used for PK fonts and \special images.
  254.   Dithering improves the readability of PK fonts, but it is a bit slower.
  255.   While viewing a page you can press "d" to toggle the dither option.
  256.   Dithering is only available under System 7 or later.
  257.  
  258. • Smoothing of non-PK fonts under ATM version 4 now works.
  259.  
  260. • OzTeX no longer displays a warning dialog when previewing a DVI file that
  261.   includes an EPSF file without a PICT 256 resource.  Instead, OzTeX draws a
  262.   rectangle showing the bounding box, along with the name of the file and the
  263.   message "no PICT" near the \special marker.
  264.  
  265. • \special markers are only shown for included files.
  266.  
  267. • The previewer now detects all dvips-specific \special commands and silently
  268.   ignores those it can't handle (like rotation and other commands that use
  269.   raw PostScript code).  Ditto for tpic \specials.  This means that most
  270.   people will never need to tick the "Ignore bad \specials" option.
  271.  
  272. • Added better support for monitors that can change the desktop dimensions.
  273.   After such a change, the view window will be reset to the standard state
  274.   if the title bar, zoom box or size box become invisible.
  275.  
  276. • The previewer can now handle EPSF files with "%%BoundingBox: (atend)".
  277.  
  278. • You can now type "o" while TeX is running and the previewer will open the
  279.   DVI file at the end of the run (previously the "o" event would be gobbled
  280.   by the routine that checks for command-dot).
  281.  
  282. Printing
  283. --------
  284.  
  285. • OzTeX's low-level PostScript printing code now works under QuickDraw GX
  286.   (on both AppleTalk and serial printers).
  287.  
  288. Configuration files
  289. -------------------
  290.  
  291. • Here are the new parameters:
  292.  
  293.   pstool_output = <filename>
  294.   Sets the default name of the output file created by PSbook, PSnup, etc.
  295.   The Default config file sets the name to out.ps.
  296.  
  297.   missing_picts = <color>
  298.   Specifies the color of the box and message seen when previewing an EPSF
  299.   file with no PICT.  The Default file sets the color to red.
  300.  
  301.   hypertex_links = <color>
  302.   Specifies the color of HyperTeX links.  The Default color is green.  
  303.  
  304. • These parameters are no longer used:
  305.  
  306.   dvips_application
  307.   dvi_to_ps_prolog
  308.   standard_prolog
  309.   global_ps_file
  310.   dvidvi_examples
  311.   conserve_vm
  312.  
  313.   Some corresponding files have been deleted from the PS-files folder:
  314.  
  315.   DVItoPS.pro
  316.   OzTeXdict.pro
  317.   global.ps
  318.  
  319. • Because OzTeX uses dvips (which gets PostScript font info from psfonts.map),
  320.   the list of PostScript fonts in an OzTeX config file is only used when
  321.   previewing, or when printing on a non-PostScript printer.  This means that
  322.   the printer font names and download entries are no longer used by OzTeX.
  323.   However, I decided not to alter the syntax of PostScript font lists, so
  324.   there is no need to change the font lists in your own config files.
  325.  
  326.   To simplify the Default config file, I've removed all the 8r-/EX-/CO-/SL-
  327.   prefixes.  This makes it easier to compare the entries in psfonts.map.
  328.   I've also removed the "<" entries from all config files.  But again, this
  329.   wasn't really necessary -- OzTeX will silently ignore such entries.
  330.  
  331. • The ps_folders list in the Default config file now includes :DVIPS:Inputs:
  332.   so dvips can locate various files (config.*, psfonts.*, *.enc, *.pro).
  333.  
  334. • The ps_folders list also includes the special entry "$f".  OzTeX replaces
  335.   $f with the path to your system fonts folder so that dvips can locate
  336.   PostScript font files.  The ps_folders lines have been removed from the
  337.   various "Add ... Fonts" config files, along with the corresponding warnings.
  338.  
  339. • In the "Add Lucida Fonts" config, the screen font info for lbsl has been
  340.   changed from "LucidaBright Mac.enc i" to "LucidaBrightSlant Mac.enc".
  341.   Also added the "$7F $C4" encoding to :PS-files:Encodings:LucidaNewMath.enc.
  342.   Also updated and corrected :PS-files:Encodings:Mac8r.enc.  [Thanks Bruno.]
  343.  
  344. • TeX's trie_size parameter can now go up to 65000.  Handy for languages like
  345.   German that can require lots of hyphenation patterns.
  346.  
  347. • Just before running TeX, OzTeX will load <format>.config if it exists in
  348.   the same folder as the input file.  This is handy for people who use both
  349.   LaTeX 2.09 and 2e and need to switch to different input_folders.  No need
  350.   to manually select appropriate config files; just create LaTeX.config and
  351.   LaTeX209.config (or whatever matches the names of your .fmt files).
  352.  
  353. • The "Big TeX" config file has been removed.  I decided this was a silly
  354.   approach because if you need to use big formats then you might as well
  355.   use them all the time and just call them Plain.fmt, LaTeX.fmt, etc.
  356.   The big TeX parameters are now stored in the notes at the end of the
  357.   Default config file, along with new instructions.  The User Guide section
  358.   on building big formats has also been modified.
  359.  
  360. • The hyperref package uses a lot of macros, so I've increased a couple of
  361.   TeX parameters in the Default config file (hash_size and hash_prime) and
  362.   rebuilt all format files.  I've also increased OzTeX's preferred memory
  363.   size by 100K.
  364.  
  365. Virtual fonts
  366. -------------
  367.  
  368. • The "Fix VFs" items have been removed from the TeX menu.  There is no longer
  369.   any need to fix virtual fonts in a DVI file before previewing/printing
  370.   because OzTeX now handles such fonts on the fly, just like dvips.
  371.   (Actually, "Fix VFs in DVI" has just been renamed to DVIcopy in case people
  372.   still want to use that tool for some reason.  Note that DVIcopy can cause
  373.   some subtle problems -- see the new DVIcopy help file for details.)
  374.  
  375. • The View menu's Page Info item shows virtual font information if any VF
  376.   files are used in the DVI file.  Note that if virtual fonts are used then
  377.   Page Info won't necessarily detect all missing PK fonts.  A missing PK font
  378.   referenced in a virtual font will only be detected if a character requiring
  379.   that PK font is used somewhere on the current page.
  380.  
  381.   Previously, Page Info could be used to detect ALL missing PK fonts without
  382.   having to preview every page.  This is no longer feasible with VFs because
  383.   OzTeX would have to preload ALL local fonts referenced in all VFs, and that
  384.   would be highly undesirable (because some local fonts might never be used).
  385.   Use dvips and create a .ps file if you want to detect missing PK fonts.
  386.  
  387. Miscellaneous
  388. -------------
  389.  
  390. • "Use Format in Log" has been removed from the TeX menu.  Too many people
  391.   were getting stuck after creating a log file with the wrong format.
  392.   A better and safer way to force a particular format is to include a line
  393.   like "%&LaTeX" or "%&Plain" at the start of your input file.
  394.  
  395. • All new TEXT files created by OzTeX now have your chosen editor's signature,
  396.   so double-clicking on a new .log/aux/toc file will open it in the editor.
  397.   Note that OzTeX won't change the signature of existing files, so you can
  398.   still double-click on your old .log files to start up OzTeX.  If you want
  399.   to do that after creating a new .log file, just use ResEdit or some other
  400.   utility to change the file's creator signature to "OTEX".
  401.  
  402. • Given foo.x.tex, TeX now creates foo.x.dvi and foo.x.log.
  403.   This is consistent with how Metafont/MetaPost/dvips handle mf/mp/dvi files.
  404.  
  405. • If you renamed your text editor and then typed "e" in response to a TeX
  406.   error then OzTeX would display a cryptic warning message.  Now you will be
  407.   asked to select the text editor again.
  408.  
  409. • The magnification string passed by OzTeX to MakeTeXPK is now identical to
  410.   the string passed by dvips.  This guarantees that PK files created by either
  411.   caller will be identical (apart from the creation date).  OzTeX was using a
  412.   slightly different method for calculating the magnification and some unusual
  413.   cases, like a DVI magnification of 833, could result in PK files with minor
  414.   differences.  Not enough to be visible, but potentially confusing.
  415.  
  416. • Fixed a bug that's been around for some time (since 1.7).
  417.   If you used LaTeX's graphicx package, then a command like
  418.      \includegraphics[height=1in]{test.epsf}
  419.   would result in a spurious "Bad BoundingBox" error when PostScript printing
  420.   and an unscaled image when previewing or non-PostScript printing.  The bug
  421.   only occurred if "height" was used by itself.
  422.  
  423. • The new REVTeX subfolder in TeX-inputs contains the latest REVTeX 3.1
  424.   release (including the revtex.cls patch for LaTeX2e).
  425.  
  426. • The AMS folder has been updated with the latest versions of AMS-TeX,
  427.   AMS-LaTeX and AMSFonts.
  428.  
  429. • The TeX-inputs folder has been updated with the Dec 1996 release of LaTeX.
  430.   Note that I've removed oztex.def from the Graphics subfolder; OzTeX now
  431.   uses dvips.def.
  432.  
  433. • The escape key or command-dot can now be used to cancel all dialog boxes
  434.   with a Cancel button.  The escape key can also be used like command-dot to
  435.   cancel lengthy tasks.  Ditto for OzMF and OzMP.
  436.  
  437. OzMF
  438. ----
  439.  
  440. • Given foo.x.mf, Metafont now creates foo.x.log etc.
  441.  
  442. • Updated AFM2TFM to version 8.1.
  443.  
  444. • Fixed a bug in VPtoVF that could result in a hung Mac.  Fortunately the bug
  445.   only occurred if a .vpl file had no MAPFONT declarations (very unlikely!).
  446.  
  447. OzMP
  448. ----
  449.  
  450. • OzMP is an implementation of John Hobby's MetaPost program for producing
  451.   PostScript pictures using a Metafont-like language.  The OzMP application
  452.   should be kept in the same folder as OzTeX, along with the MetaPost folder.
  453.   See the new OzMP section in the User Guide for more details.
  454.